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INTRODUCTION 


FORTE’ is an interpretive lanquage devoted to the playing of music. 


 ceeeneieitimeeneniaineietemiinsente a kame a he - 


This language allows the operator to use the music playing capabilities 
of the APPLE II computer in a way thet, up until now, required hours of 
tedious calculations and coding to play only a few notes. With FORTE', 


at! of the hard work has been done for you. 


The programs written In FORTE’ are as casy to enter, list and edit 


[oe ee ee 38 é@fe programs written in APPLE‘s INTECER BASIC. Debugging a program 
Se Se SEE T is even easier. If the operator is familiar with the procedures used to 
write a BASIC program on the APPLE, using FORTE’ will be all the easier. 

hype i FORTE’ can play music from either one of two operator specified 
an Outputs. ey using the appropriate command, the operator can play music 

from the speaker built into the computer, or from the cassette output 


for cecording on to a high fidelity music system plugged into the output 


port. 


Programs written in FORTE’ are easily saved onto cassette or disk 


and cen be listed to o printer for hardcopy documentation. 


s ceateemenetimeainentilinetietton edie aes ~ 


Se ee 


FORTE’ was developed to be easy and fun for the beginner, yet 
sapable of handling the most complex passages the veteran can devise. 


Read the following information cerefully then loed up FORTE' and enjoy 


maaing your own beautiful music! 
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All rights reserved. This document, or the software 
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GETTING STARTED 


LOADING FORTE 


FORTE* was developed and written in machine language for maximum 


speed and versatility. In order to ease the burden on the operator, 


FORTE’ has been configured to load in INTEGER BASIC. Do not try to LIST 


FORTE’ as it will appear as garbage on the screen. 


FORTE’ is loaded 


into your computer using the Integer BASIC >LOAD 


command. The leader tong on the cassette should be positioned under the 


Play head and the recorder set in the PLAY mode before the <RETURND key 


is pressed. 


ENABLING FORTE 


After two beeps are heard and the *">* prompt and flashing cursor 


re-appear, type in RUN <RETURN> to start FORTE'. A header will be 


Printed at the top of the screen and @ "%° prompt with the flashing 


Cursor will indicate that FORTE' is now ready to accept commands. 


RECOVERY FROM ACCIDENTAL RESET 


RESET’s are easily recovered from by typing in *808G <RETURN> from 


the monitor. The 


“¥" prompt and flashing cursor wil] re-appear. If 


these results are not obtained, FORTE’ will have to be re-loaded and the 


FORTE’ music re-entered. 


FORTE DISK VERSION 


FORTE’ may also run on a Disk based APPLE II with only slight 


chenges in operation. Setting up FORTE’ to cun with the Disk drive is 


easy and once set up, cassette tapes can be used as backup protection 


for your FORTE’ programs. 
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Refecing to the APPLE II Disk Subsystem Manual, BOOT the DOS from a 
diskette in your collection into your computer. When the °>" prompt 
appears with the flashing cursor, insert the diskette on which you wish 
to save FORTE’ into the Disk [f Drive. Now Insert the cassette tape 
containing FORTE’ Into your cassette player and position the leader tone 


under the Oa. Type the >LOAD command into the APPLE. Start the tape 


in the PLAY mode and press <RETURN>, When the APPLE beeps twice and the 


">" prompt and flashing cursor return, FORTE’ is now loaded into memory. 
At this point, DO NOT RUN FORTE'. Place into your drive the diskette 


you wish to save FORTE' on and type: 

>SAVE FORTE',Vv,0d,Ss <RETURN> 
Where v=volume number, dsdrive number and s*slot mumber. These are 
optional as needed. Refer to’ the APPLE Disk Subsytem Manual for 


specifics. 


After the DOS has been booted in the standard manner, typing in 


2RUN FORTE’ <RETURN>D will enable FORTE’ for your use. 
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FORTE IMMEDIATE EXECUTION COMMANDS 


CAS LIST RUN TRACE 
Sea CON LOAD SAVE TRAC EN 
‘ccna = +s 8 oo <CONTROL C> NEW SPD 
DEL NOTRACE SPK 
PREE RES TORE STEP 
Ss These commands are See Progr eheete, They may be use only in the 


IMMEDIATE MODE of operation (ie. directly from the keyboard). The 


cheracters are inter 
these commands in a 


appearing and prog 


program execution, 


COMMAND DEFINITIONS 


CON 


i ee ee . ‘ “ - ~ ee 


ead © + RNa sorta RE ase Maem ae — « _ 


preted differently by a running program. Use of 
program will result in either a ttt®*SYNTAX ERROR 


ram execution being terminated, or unpredictable 


Dicects the music to the “CASSETTE OUT" port of the 
APPLE for recording the song as music on tape or for 


playing the music to an attached Hi-Fi or PA system. 


Continues execution of a program halted by either a 
Keates) C (Cc) entered at the keyboard or an “5S” 
Statement included in the FORTE program. Execution 
resumes at the line number displayed when the halt 


occured. 
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——= or ‘ Re = = 
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NENT NR RNR eo 
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ON cr eR 
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Entered from the keyboard, halts execution of the ‘3 iit 
FORTE’ program currently belng run. The line number 
in which the halt occured is displayed. Execution 
may be resumed at the displayed line number with the 


CON command, 


Deletes from a FORTE’ Program the line specified by 


n. 


Deletes range of program lines Starting at line n} 
and ending at line n2. Lines deleted in this manner 

are not recoverable. 

Displays the number of free bytes remaining In . : a 
memory. The number is displayed in decima} and 
includes the area occupied by DOS if you are using a 


disk version of FORTE’. : abe Si ak auth 


Lists the program on the Screen starting at the 
lowest line number and continuing until the laste 
line has been displayed. Pressing any key during the sei 
listing will freeze the scrolling to allow the 
opecator to inspect part of the program, Pressing 
any key will cestart the Scrolling. Pressing any two 
keys on the keyboard Simul taneously will step the or 
listing one line at a time. at any time during e 
LISTing, hitting a Control ¢ (Cc) will exit the LIST 


mode and return you to the Command Mode. 


w= © 
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LIST n Lists only the Line number n. 


LIST n},n2 Lists @ portion of the FORTE’ program starting at 


line number nl and ending at line number n2. 


seailieelOiiitdicnaink Soa LOAD Loads 8 FORTE' program from cassette tape into 
memory. The leader tone on the tape should be 
positioned under the pl ay-back head of the player. — 
Put\the cassette player in the PLAY mode before 


sbiinisthn Wm sack hitting the RETURN key on the computer. i Na ahs 


LOLA IOI LS = — A eee ean ee eC aeehiaienemnnel 


NEW Clears current program pointers to zero. (eq. FORTE' 

a . is no longer looking at that portion of memory 
—— ——— containing the music program). FORTE’ is then ready ee ee 
a, . to accept a new program. If the NEW command is used 
fy accidently, and no other lines of FORTE' program 


have been entered,a RESTORE command may be used to 


paisa a ater ed Be a recover the the program. eR Re ess eee ces 

ee “i - ~ ee eer 
MOTRACE Cancels both TRACE and TRACEN modes of operation. 

EE ROE FE: Se PRE n Transfers output of screen to 1/0 slot specified by ae ES SRE TE Np RSet 


expression n. PR#O is the video output and not an 


eens tel oo . fe OO ee OED we + Cet ae ements 


I/O slot. It is used to cancel output to any other 


Slot. The port specified would be used by FORTE’ 
tak Se alas ly for text output, either “ " statements or listings, ay Pre te rine any 
to a printer or other communications device attached 


ee 


to slot n. \ 


PES ND A ED e = os 8 et Oe mee SRNR 
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RES TORE Restores program pointers after an accidental NEw 
Mae command, If this command is used at any other time, 
9 ik @ %€8etetCAN'T RESTORE error will result. ae 
a Additionally, this command will not work if the ee 
' . wii ates has already begun to enter new lines for a 


es Rae. new FORTE’ program. } 


g 


-Runs the FORTE’ program Starting at the first line wen 


number of the program. 


RE NEE ME A NE SR! A ew 


a eee RUN n Runs the FORTE’ program starting at line number n. 


ee Oe Se ee eee 6 


SAVE Allows the operator to save a FORTE’ program from 


memory onto & cassette tape. The cassette recorder ‘ a 
i eet ee een se oe should be in the RECORD mode and running before ras 
' eae eae <RETURN? {is pressed. Re ree a Sete 
tithe Aa a SPD n Sets speed at which lines of FORTE program are 
Se ie oe es wee ne displayed during a LIST. A value of 1 for n gives a 
5 ae the slowest LIST speed while a value of 255 gives © beeen se eee 
a" you the fastest. Note: The SPD has nothing to do 
with the speed at which a FORTE’ program is RUN, 
nT Fe SPK Directs the music to the Speaker port of the APPLE. ¥ ite 
This is the default mode of operation. = 
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STEP 


STEP n 


TRACE 


TRACEN 


Used instead of RUN, this command allows the 


operator to step through the FORTE’ program note by 
note wien any key on the key board is pressed (again 
with the exception of the CRESET> key!). When used 
with the TRACEN command, the note name and octave 
number is displayed along with all the operating 


Statements. The <RETURN> key Continues running the 


program without the STEP. Hitting the <ESC> keys 


\ 
returns the system to the FORTE’ command mode as 


identified by the return of the "%" prompt and the 


flashing cursor. 


& 


Runs the program in the STEP mode starting at line 


Number n. 


Displays the line number of the current program line 


being executed by FORTE’. May be used with TRACEN. 


Displays the current note and octave number being 
Played. The octave number is displayed even if a 
default value was used. You may exit this mode by 
hitting @ Control C (Cc). This will return you to 


the Command Mode. 
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FORTE OISK COMMANDS 


CATALOG LOAD name SAVE name DELETE name 
These commands are the only ones used by FORTE’. Tne rest of the APPLE 
Disk I] commands may not be used by FOATE’. 


\ 
OISK COMMAND DEFINITIONS 


CATALOG Displays the disk volume number and a list of files 


on the disk. 
LOAD name - Loads the program indicated into memory. 


SAVE name Saves 8 program onto the disk. The name is used by 


the DOS to identify that program for all future disk 


commands. The name may be up to 32 cheracters in 
length. The only cestriction In naming a FORTE’ 
programa is that the first cheracter of the name must 
be alphabetic. 

DELETE name Removes the named file from the diskette. 

For clarity, the mention of volume numbers and any drive or slot numbers 


has been omitted from the above examples. Clarification on thelr use, 


if needed, can be found in the Disk Subsystem Manual. 
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FORTE DEFERRED — EXECUTION STATEMENTS 


u U {(n: ) T 
* x N 
e S$ Vv 
J Q P 


These statements, with the exception of the U and X statements, may be 
used in the Immediate (command) mode. Multiple statements per line are 


‘; 
permissible. 


Some definitions: 
a- This symbol will be used to indicate a note to be played. 


nm - This symbol will be used to {indicate an integer number between 


1 and 255 (unless otherwise indicated). 


DEFERRED —- EXECUTION STATEMENT DEFINITIONS 

u Clears the screen and homes the cursor to the left 
side of the screen and vertically to line 12. The 
next print statement will operate at this line. 
EXAMPLE: 


$104 


Print statement. Prints all characters from the 
or fiest *° to the second * of to the end of the program 
line. A Carriage returcn/Line feed is issued at the 
Second “ or at the end of the program line. 
EXAMPLE: 

t 168 


& 28 ° SONG TITLE ° 
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Remark. Allows the programmer to insert remarks 
into the program text. Remarks are considered as 
ell characters from the * to the end of the program 
line. Remarks are not printed during program 
execution. 
EXAMPLE: 

% 28 ° SONG TITLE ° 

& 38 * SONG STARTS HERE 


Jump statement. Similar to a COTO statement tn 
INTEGER BASIC. Causes program to perform an 
unconditional jump to a line number specified after 
the J statement. 
EXAMPLE: 

& 38 * SONG STARTS HERE 


8 48 J12@ 


Use subroutine. Similar to a GOSUB statement In 
INTEGER BASIC. Causes the FORTE' program to utilize 
@ subroutine starting at the line mumber specified 
after the U statement and ending with the xX 
Statement. When the X is encountered by the 
program, 8 feturn to the statement after the U 
Statement is performed. Subroutines may be nested 
up to 16 deep. 
EXAMPLE: 

% 48 31208 

& 5@ Vilees 
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Exit subroutine, Similar to RETURN In INTEGER 
BASIC. Marks the end of a subroutine and returns 
program execution to the statement after the ¥ 


Statement that called the subroutine. 


EXAMPLE: 
% 50 Ulege 
&% 16600 x 
\, 


Stop. Causes a halt in the progran. Action Is 
similar to the Control C. Resumption of the program 
at the displayed line number may be accomplished by 
using the CON command. 
EXAMPLE: 
% 1600 x 


% 10185 


Quit. Causes termination of the program and returns 
the *"%° prompt and the flashing cursor. Program 
execution is NOT resumed by the CON statement. 
Generally used to mark the end of the program if the 


end {3 above the subroutines. 


EXAMPLE: 
% 1018S 
& 1028 9 
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Indicates to FORTE' to repeat the pessage inside the 
parenthesis nm number of times. Repeats may be 


nested up to 16 deep. An open parenthesis aust 


proceed each number and «a close pacentheses must Sr 
close each passage. The number n must be followed | : 

by @ “:" character. , 

EXAMPLE: | cee utile 


4 1038 (3: @ @ & a) 


% 1048 (2:(3: a aa a) a a) 


Used inside the repeat function. Indicates that the aa 

a 
“motes of statements after the N statement are , "pa sineaaes 
operated on after the nth cepeat of the passage. ; 


The N applies to the entire remainder of the line on 


which it appears. 


EXAMPLE: aia a> cael 
.} 1640 (2:(3: a aaa) a a) 
8 1850 (4:(2: aaaaN2a 
8 1055 ) a N3 a) Bi 
ia aoe 
Voice. Indicates the voice number the following oe pain 
notes are to be. The voice mumber must be between } 
and 6. Any other number will result in an error. aes ras 
EXAMPLE: - <a Recotaht 
8 1858 (4: (2: a a aaN2 a) : = 
% 1660 V6 
81078 ) a N3 a) ; ese 
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Pause. Indicates @ pause to take place before the 
execution of the next statement. Pauses are 
indicated by an integer number entered after the P 
statement. The shortest pause is 1 second and the 
longest is 255 seconds. Pauses for fractions of a 
second may be set using the rest statement. 
EXAMPLE: 
% 1069 V6 


\ 
% 1875 P3 


Tempo. Indicates exactly how many quarter notes are 
to be played each minute. Tempo number I[s indicated 
by an integer mumber enteced after the T statement. 
1 is the slowest tempo and 255 is the fastest. 
EXAMPLE: 

&% 1070 P3 


& 1680 T1280 
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FORTE NOTE VALUES AND OCTAVE NUMBERS - 


With FORTE’, octaves begin with the note A and end with the note 


Gi. The note names within each octave are as follows: 


a AE 2 fC. Oe CP ore Gc Gs 


There are seven octaves avallable in FORTE’, They are simply 


numbered 1 through 7 with 7 being the highest octave. When entering a 
; X 


note to be played, entecing the octave number after the note name 
indicates in which octave that note Is to be played tn. The entry C3 


indicates to FORTE' to play a middle C note. 


FORTE’ instructs the APPLE II to play the desired notes according 
to the equal tempered Scale, which is standard for the plano. The note 


AJ is the standard 449 Cycles per second. 


A one octave scale Is Played by the following short program; 
& 18 V2 T1i25 


& 28 A4/4 B4 C4 D4 £4 PE Ge AS 
8 389 
8 RUN 


FORTE TIME VALUES 


FORTE* allows the use of time values for each note or group of 


motes. These time values are used to determine how long 4 note is 


Played. Time values are entered after the note name and octave number, 


preceeded by a °/* character. Thus, @ middle C quarter note would be 


entered as C3/4. 
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ENTRY VALUE NOTE SYMBOL 
f WHOLE NOTE = 

{2 HALF NOTE 4 

4/4 QUARTER NOTE ° 

/8 EIGHTH NOTE ? 
/16 SIXTEENTH NOTE | © \ 
{32 ; THIRTY SECOND NOTE 7 \ 
/64 SIXTY FOURTH NOTE e 


Time values may be altered according to standard practice. The 


alterations available are the dotted note and the triplet note. 


A dotted note Is played half again as long as the indicated time 
value. Example, a whole note of a half second duration is played for 


three quarters of a second If dotted. 


A triplet note is played for only one third of {ts Indicated value. 
Example, tf a whole note of a half second duration is entered as a 
triplet, {it only plays for on sixth of a second. Three triplet half 


notes would occupy the same time span as a Single note. 


Dotted of Triplet notes are indicated by a *.* character or a °!" 


character entered after the time value for the note. EXAMPLE: 


C4/4. Indicates a dotted quarter note. | a: r. "| ‘ 
C4/4t Indicates a triplet quarter note. Ay 
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FORTE RESTS 


———S ee ee we me ee ee 2 ome ame se 6 


Rests ace indicated by entering an R character and the time valve 


desired (preceeded, of course, by a °/" character). 


R/B R/16 R/32 


EXAMPLE: 


FORTE’ allows the musician/programmer an advantage where rests are 


involved. 


useful. 


FORTE DEFAULT VALUES 


For the programmer's convenience, and to conserve 


Dogted and Triplet rests are legal and at times, highly 


memory space, 


FORTE’ allows the use of default values to be used for the program | 


notes. All values, with the exception of the note 
indicated once and need not be specified again until 
desired. 
EXAMPLE: 
& 1004/4 B84 A4C3/2. BR 
818 C4/4 84/4 A4/4 C3/2. —R/2. 


8 1604/4 BA C3/2. R/2. 


All three of these lines of program would play the same. 


may only be specified for programmed notes. 
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FORTE SAMPLE PROGRAM 


A sample program written in FORTES for playback out of the APPLE 


II's speaker would look like the following: 
& LIST 


16 H° FORTE’ SAMPLE \SONG PROGRAM * av 
20 ° WRITTEN ON THE APPLE COMPUTER" 

30 T175 Vi P2 

49 £4/8 G/4 AS/8 B C/16 B/8 

56 A FS4 D E/16 FE/8 

609 G/8 E & D#/16 £/8 FE/4 DE/8 B/4 R/B 

78 € G/4 AS/S B C/16 B/S 

BC A/4 FE4/8 0/4 E/16 FE/B 

99 G FEE DF CH DE E/4 E/B E 

180 05/4°D/8 Ci B A/4 FE4/16 D/5 E/16 

11@ F#/8G € © DI/16 £/8 FR/4 DE/B B/4 R/B 
128 05/4 0/8 Ce B a/4 FE4/16. D/8 £/16 


130 F8/8 G Fe E DE CH DOE E/4 E/BE 


14@ P2 ° DID YOU GUESS THE NAME OF THIS SONG?® 
158 Q 
a 
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7 : FORTE QUICK REFERENCE GUIDE 
nd 9. ae 
Se eg ee IMMEDIATE EXECUTION COMMANDS 
CAS Specifies cassette port as current music output. 
cS ae CON Continue after a Ce or & (STOP) 
Ce Keyboard entry. Halts program execution. 
ee DEL Deletes specified program lines from memory. 


FREE Displays number of bytes free for program 
; LIST Lists FORTE’ program. 
ae a as LOAD Loads FORTE’ program from cassette. 


ee a : Nil Deletes current program from memory. 
ee ae es ONS Lee ee NOTRACE Cancels both TRACE and TRACEN modes. 
' : RESTORE Restores program if used immediately after NEW 
u RUN Runs program currently in memory. 
rr co SAVE Save 3, FORTE* program onto a cassette. 
“ | ‘ SFO Sets speed of Listing display. 
SPK Specifies speaker port as current music output. 
agit oe STEP Steps through program each time a key is pressed. 
ik TRACE Displays current Line number being played. 
(CS Sere Fe TRACEN Displays current note and octave number being played. 
DEFERRED EXECUTION COMMANDS 
: : ee H Clears the screen and homes the cursor. 
= ee Prints on screen all characters between quotes. 
SE ee Sh e Remark. All characters to end of line. 
J Jump. Similar to GoTo. 
SE OE ee EC a er U User subroutine. Similar to GOSUB. 
* x Exit subroutine. Returns to statement after the U. ‘ 
S Stop. Displays lime number where Stop occured. 
eneaiillllineetiemmienn Q Quit. Ends execution of FORTE’ program. 
{m: } Repeat passage inside parens n number of times. 
Es u Repeat modifier. ; 
ee MEE oc ak a pe Vv Voice number. Between 1 and 6&6. 
P Pause. Between 1 and 255 seconds. 
Be rae me T Tempo. Number of Quarter Notes to be played each minute. 
S50 Ns i VALIO FORTE NOTES 
ee A Ab B C C$ DO Dt & FP PI G GI R @ gest 
OCTAVE NUMBERS 
a= ere l <---> 7 
O_O eT ERIE ye TIME VALUES 
41 whole note 
42 half note 
OTR LR SATS, 2a SO ee 44 quarter note 
/8 eighth note 
Pied 6 se S: 416 Sixteenth note 
dae nr 432 thirty-second note 
/64 sixty-fourth note 
* Sale oe ° Dotted note played half again as long as time value. 
i Triplet note played one third as long as time value. 
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FORTE ERROR MESSAGES 


VERESYNTAX ERROR 


BURACAN'T CONTINUE 


RRURCAN'T RESTORE 


$80%>65535 ERROR 
$08%>255 ERROR 


BU8E1G6 NESTED REPEATS 


VERLUNMATCHED REPEAT °)*° 


VEGRCONDITION OUTSIDE OF REPEAT 
$808>16 UTILITY SUBS 


QVBQNO SUCH LINE 


RERRINVALID EXIT 


VUREINVALID VOICE NUMBER 


ERR 


-“-— —-— *- © =. 
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POSSIBLE CAUSES 


Misspelled or incorrect command. 
Incocrect or incomplete statement In 
the program, 


A CON command was entered when 
program execution was NOT halted by 
either a Control C (Cc) entered at 
they keyboard or an S statement in 
the program. 


A RESTORE command was entered at 
sometime other than immediately after 
a NEW command was issued. 


A line number greater than 65535 was 
entered, 


A Tempo, Spd, or Pause was entered 
with a value greater than 255. 


More than 16-repeats were nested 
together in the program. (2: (3: (3: 
}}} is considered as three nested 
repeats. 

Program execution encountered a °)* 
symbol without a leading “(n:° symbol 
indicating 8 repeat. 


An Nn statement was encountered 
outside of a repeat. 


More than 16 utility subroutines were 
nested together. 


A Un or Jn statement was included in 
the program where line number n does 
mot exist. 


‘An X statement was included in the 
program either outside a utility 
subroutine or the program was RUN 
inside a utility subroutine. 


A Voice number was entered that was 
not in the range between } and 6. 


During the tape or disk loading of a 
FORTE’ program using LOAD, if the 
amount of memory available is less 
than the amount required for the 
program, this error will result. 


A tape read error was encountered. 


Possible causes and cure are listed 
im the APPLE II Reference Manual, 
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